home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbs_soft / dm_v104.zip / DEL-MISS.DOC next >
Text File  |  1993-04-05  |  8KB  |  183 lines
  1.  
  2.  
  3.                        DEL-MISS - The Files Updater
  4.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6.                     Programmed by Dave Gorski @2:250/107
  7.                   Docs performed by Phil Burden @2:250/101
  8.  
  9.          History.
  10.          ~~~~~~~
  11.          We all know how big our file areas grow,particularly when you
  12.          use  programmes  like  Tick,FileManager,Allfix etc running in
  13.          auto mode,which requires little or no work on the part of the
  14.          sysop.The trouble is,files also get deleted when new versions
  15.          arrive,or you delete  files  on  a  date  basis,in  order  to
  16.          conserve  on  valuable  disk space.The trouble is,when you do
  17.          that,you have to edit your files.bbs to  remove  the  entries
  18.          concerning  deleted  files,or  else  your filelist is full of
  19.          Missing or "stored offline" or whatever your fileslist  maker
  20.          puts when the file is missing.Well,along comes DEL-MISS,to do
  21.          that  menial  task  for  you.As  an  added  bonus,from  v1.03
  22.          onwards,it  will  even  sort  the  resultant   files.bbs   if
  23.          required.
  24.  
  25.          System Requirements
  26.          ~~~~~~~~~~~~~~~~~~~
  27.          DEL-MISS  will  run  on  any PC compatible computer,having at
  28.          least MSDos 3 or later.It was written in Turbo Pascal,running
  29.          under MsDos 5.
  30.  
  31.          Guarantees
  32.          ~~~~~~~~~~
  33.          There are none,beyond the fact that it takes up disk space.You
  34.          are advised to make backups before running  DEL-MISS,just  in
  35.          case!.No  Liability  is  implied  or accepted for any mishaps
  36.          that may or may not occur. Since it's  cost  you  nothing,you
  37.          can't expect much,right?.
  38.  
  39.  
  40.          Files in the Archive
  41.          ~~~~~~~~~~~~~~~~~~~~
  42.  
  43.          DEL-MISS.EXE the executable file
  44.          DEL-MISS.DOC your reading it!.
  45.  
  46.          Command Line arguments.
  47.          ~~~~~~~~~~~~~~~~~~~~~~~
  48.  
  49.           There  are several command line options,detailed here,but if
  50.           you get stuck type DEL-MISS -? for the help screen.
  51.  
  52.           Defaults for ALL options EXCEPT -c (Upper Case) is OFF.-C is
  53.           by default ON.
  54.  
  55.                 -d  turns debug on, gives  extended  info  in case  of
  56.                     errors.Only displays info  to  screen,NOT  to  the
  57.                     logfile.
  58.  
  59.                 -pFileSpec  and filename of the text file to  read to
  60.                     find the directories to work on,not needed if you
  61.                     are running Remote Access and have the RA
  62.                     environment variable set.
  63.  
  64.                 -b  tells DEl-MISS to create Files.Bak as it goes.
  65.                     (recommended!)
  66.  
  67.                 -lFileSpec  tells DEL-MISS the location & name of it's
  68.                     optional logfile.
  69.  
  70.                 -s  Sort the files.bbs,  intelligent  enough  to  sort
  71.                     entries    between    comment    lines.Sort     is
  72.                     alphabetical by Filename.
  73.                     See addenda for what constitutes a comment line.
  74.  
  75.                 -c  By default all filenames  are  converted  to  upper
  76.                     case, use this option if you prefer Lower case.
  77.  
  78.                 -i  Internal buffering,for use with large files.bbs,or
  79.                     a lot of them,can reduce scan time & disk access.
  80.                     
  81.                 --  Forces DEL-MISS to treat any lines which start with
  82.                     a '-' to be a comment line, usually it would  treat
  83.                     the character as a valid DOS filename and remove if
  84.                     if was missing.
  85.                     
  86.                  -? or H gives a brief help screen
  87.  
  88.  
  89.          Installation.
  90.          ~~~~~~~~~~~~~
  91.            That depends on your bbs software.DEL-MISS was written with
  92.          Remote Access in mind,and uses the Files.RA file that RA uses
  93.          to find the filearea directories.If you don't run RA,then all
  94.          is not lost,but a little work is needed to use DEL-MISS.
  95.  
  96.                 a) For those running Remote Access
  97.                    Ensure that the environment variable RA is set,
  98.                    if not use the -p option as detailed below.
  99.                    If the RA variable IS set,the -p option need
  100.                    not be specified.
  101.  
  102.                 b) For those NOT running Remote Access,but using a
  103.                    Files.bbs type files database.For this,you'll need
  104.                    a text file,detailing all the directories you
  105.                    want DEL-MISS to operate on.
  106.                    A sample file might look something like this:
  107.  
  108.                     e:\File\fileecho
  109.                     c:\geo\Works
  110.                     c:\geo\art
  111.                     c:\geo\back
  112.                     c:\geo\font
  113.                     c:\sds\Uk\admin
  114.                     c:\sds\Uk\utils
  115.                     d:\File\fossil
  116.                     d:\File\lannet
  117.                     d:\GENE\DEMO
  118.                     d:\GENE\FILE
  119.                     d:\GENE\JEW
  120.  
  121.                    A  trailing  backslash will be added by DEL-MISS if
  122.                    you don't put one,so don't worry about that.
  123.                    Use the -P option to tell DEL-MISS the location and
  124.                    name of the text file you create.
  125.  
  126.                 1) Unpack DEL-MISS into a dir of your choice.
  127.  
  128.                 2) If you run RemoteAccess, either set the environment
  129.                    variable RA to point to the directory your files.ra
  130.                    is in. Or use the -p option with your own list.
  131.  
  132.                 3) Create a small batch file to save typing all  those
  133.                    commands  in  each time,a sample may look something
  134.                    like this:
  135.  
  136.  
  137.               cd\binkley\files
  138.               del-miss -d -i -pfile.dir -s -b -lm:\logs\delmiss.log
  139.               cd\binkley
  140.  
  141.             Simply  put,it  tells  DEL-MISS  to  show  debug  info,use
  142.             internal  buffering,creates  files.bak as it goes,sort the
  143.             files.bbs,use the text file called file.dir  in  the  same
  144.             dir as DEL-MISS and log everything to delmiss.log
  145.  
  146.          Bug reports,enhancements etc.
  147.  
  148.                 Yell  at  Dave Gorski,  2:250/107,  he wrote it, I was
  149.                 suckered into doing the first tests with it!.
  150.  
  151.  
  152.          Finally..
  153.  
  154.          Have fun,this software was written with the spirit of Fidonet
  155.          ringing in the  authors  ears.   It  is  freeware,though  the
  156.          copyright  belongs  to  the  author.If you like it,drop him a
  157.          netmail  telling  him  so,if  you  don't  like  it,don't  use
  158.          it.That's all folks!..
  159.  
  160.  
  161.          Addendum
  162.          ~~~~~~~~
  163.          How does DEL-MISS know a comment line from a filename!
  164.          The following characters are always treated specially, should
  165.          DEL-MISS encounter any of these in the first column (position
  166.          1) of a FILES.BBS it will be assumed a comment line.
  167.          
  168.          Illegal Characters
  169.          ~~~~~~~~~~~~~~~~~~
  170.          0 to 32 - Null to Space
  171.          "*+,./:;<=>?[\]|
  172.          127 to 255 (Extended)
  173.          
  174.          If the line passes the above requirements but does not have a
  175.          SPACE separator, (Filename Description) format, then the line 
  176.          will be treated as a comment. If the '--' option is specified
  177.          then a SPACE character in position 2..x will not be looked for,
  178.          only Illegal Characters above and the '-' character.
  179.          
  180.          If any of these restrictions cause problems please let me know 
  181.          so the software can be updated.
  182.         
  183.